Utility
Owning Palette: NI-RFSG Main PaletteUse the Utility VIs to access additional features of the NI-RFSG instrument driver.
Palette Object | Description |
---|---|
niRFSG Initialize With Options |
Initializes the NI-RFSG device (the upconverter module and the AWG module). This VI has the capability of receiving the AWG resource name through option string. This VI performs the following initialization actions: - Creates a new IVI instrument driver session. - Opens a session to the device you specify in the resource name parameter. - If the reset device parameter is set to TRUE, this VI resets the device to a known state. - Returns a value for the instrument handle parameter that you use to identify the instrument in all subsequent NI-RFSG VIs. Supported Devices: NI 5650/5651/5652/5670/5671/5672 |
niRFSG Commit |
Asserts the configured hardware parameters. Calling this VI moves the NI-RFSG device out of the Configuration state and into the Committed state. After calling this VI, changing any property reverts the NI-RFSG device to the Configuration state. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Wait Until Settled |
Waits until the RF output signal settles. This VI is useful for devices that support on-the-fly (dynamic) configuration changes (changes while in the Generation state). Call this VI after making a dynamic change to wait for the output signal to settle. You can also call this VI after calling the niRFSG Commit VI to wait for changes to settle. This VI is not needed after calling the niRFSG Initiate VI because the niRFSG Initiate VI does not return until the output is settled. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Configure Output Enabled |
Enables or disables signal output. You can call this VI in any software state, and it does not change the current state. Setting the output enabled parameter to FALSE while in the Generation state stops signal generation although generation continues internally. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Reset |
Resets all properties to their default values and moves the NI-RFSG device to the Configuration state. This VI aborts the signal generation, clears all routes, and resets session properties to the initial values. During a reset, routes of signals between this and other devices are released, regardless of which device created the route. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Reset Device |
Performs a hard reset on the device, which consists of the following actions: - Signal generation is stopped. - All routes are released. - External bidirectional terminals are tristated. - FPGAs are reset. - Hardware is configured to its default state. - All session properties are reset to their default states. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Self Test |
Performs a self-test on the NI-RFSG device and returns the test results. This VI performs a simple series of tests to determine whether the NI-RFSG device is powered up and responding. This VI does not affect external I/O connections or connections between devices. Complete functional testing and calibration are not performed by this VI. The NI-RFSG device must be in the Configuration state before you call this VI. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
niRFSG Self Cal |
Performs an internal (self-) calibration on the device. If the calibration is successful, new calibration data and constants are stored in the onboard nonvolatile memory of the module. Supported Devices: NI 5610 (upconverter only mode), NI 5650/5651/5652/5670/5671/5672 |
rfsg_Resample and Write |
Resamples the complex waveform to the new IQ rate and writes it to the NI-RFSG device. This VI preserves the phase continuity of a phase-continuous complex waveform while resampling. Supported Devices: NI 5670/5671/5672 |
niRFSG Error Message |
Converts a error code returned by an NI-RFSG VI into a user-readable string. Supported Devices: NI 5650/5651/5652/5670/5671/5672 |
niRFSG Revision Query |
Returns the revision numbers of the NI-RFSG driver and the instrument firmware. Supported Devices: NI 5650/5651/5652/5670/5671/5672 |
niRFSG Query Arb Waveform Capabilities |
Queries and returns the arbitrary waveform capabilities of the NI-RFSG device. These capabilities are related to the current device configuration. The NI-RFSG device must be in the Configuration or Generation state before you call this VI. Supported Devices: NI 5670/5671/5672 |
niRFSG Perform Thermal Correction |
Corrects for any signal drift due to temperature variation when generating the same signal for extended periods of time without a parameter change. This VI compensates automatically for variations in device temperature when any signal generation parameters are changed. Under normal circumstances of short-term signal generation, NI-RFSG automatic compensation ensures stable power levels, and you do not need to use this VI. Use this VI when generating the same signal for a long period of time in a temperature-fluctuating environment. The NI-RFSG device must be in the Generation state before you call this VI. Supported Devices: NI 5650/5651/5652/5670/5671/5672 |